MC_MoveLinearAdditive

Function block MC_MoveLinearAdditive
Commands an interpolated linear movement on an axis group from the current position of the tool center point to a relative position in the specified coordinate system. The relative distance is added to the current set position at the time of the execution.
VAR_IN_OUT
V GroupIn AXES_GROUP_REF Reference to a group of axes. References are zero based. You can have up to 32 groups.
VAR_INPUT
V Execute BOOL Starts the motion at rising edge.
V ContinuousUpdate BOOL

If TRUE, when the function block (FB) is running and the values of the parameters are updated, the FB will use the new value. If FALSE, the FB won't use the new value.

NOTE:  This parameter is not supported.
V Distance ARRAY [0..63] OF LREAL ARRAY [0..63] of relative distance for each dimension in the specified coordinate system.
V Velocity LREAL Maximum velocity of the path for the coordinate system in which the path is defined. Always positive. Not necessarily reached. [unit/second]
V Acceleration LREAL Maximum acceleration. Always positive. Not necessarily reached. The unit is determined by MC_ProfileType. [unit/second2] or [second]
V Deceleration LREAL Maximum deceleration. Always positive. Not necessarily reached. The unit is determined by MC_ProfileType. [unit/second2] or [second]
V Jerk LREAL Maximum jerk. Always positive. Not necessarily reached. The unit is determined by MC_ProfileType. [unit/second3] or [second]
V CoordSystem MC_CoordSystem A coordinate system.
V BufferMode MC_BufferMode Defines how to blend the velocity of two function blocks.
V TransitionMode MC_TransitionMode Inserts a transition curve.
V TransitionParameter ARRAY [0..63] OF LREAL Additional parameter for the transition mode. If TransitionMode is set to mcNone, this parameter has no effect.
VAR_OUTPUT
V Done BOOL Commanded end positions reached for all axes.
V Busy BOOL The function block is not finished.
V Active BOOL The function block has control on the axis group.
V CommandAborted BOOL The command is aborted by another command.
V Error BOOL Signals that an error has occurred within the function block.
V ErrorID MC_Error Error identification.
  • For more information about how absolute, relative, and additive work, see Motion.
  • For more information about how the blending modes work, see Concepts > Blend movements.

  • When you use blending in MoveLinear functions, you need to select a TransitionMode and fill in TransitionParameter. If you set them to mcNone and NULL with a blending mode, an error will occur.

 

  MC_MoveLinearAdditive  
AXES_GROUP_REF   GroupIn   Group   AXES_GROUP_REF
BOOL   Execute   Done   BOOL
BOOL   ContinuousUpdate   Busy   BOOL
ARRAY [0..63] OF LREAL   Distance   Active   BOOL
LREAL   Velocity   CommandAborted   BOOL
LREAL   Acceleration   Error   BOOL
LREAL   Deceleration   ErrorID   MC_Error
LREAL   Jerk        
MC_CoordSystem   CoordSystem        
MC_BufferMode   BufferMode        
MC_TransitionMode   TransitionMode        
ARRAY [0..63] OF LREAL   TransitionParameter